home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 007a / pafabl12.zip / PAFABLTY.DOC < prev    next >
Text File  |  1991-09-19  |  25KB  |  781 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                       PAFAbility
  34.  
  35.                                      Version 1.2
  36.  
  37.                                   Thur 19 Sept 1991
  38.  
  39.              (c) Copyright 1991, Barbara A. Bennett. All Rights Reserved.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                    PAFAbility v1.2
  74.           ----------------------------------------------------------------
  75.  
  76.           Contents
  77.           --------
  78.  
  79.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   1
  80.  
  81.           Hardware Requirements . . . . . . . . . . . . . . . . . . . .   1
  82.  
  83.           Using PAFAbility  . . . . . . . . . . . . . . . . . . . . . .   1
  84.              WARNING  . . . . . . . . . . . . . . . . . . . . . . . . .   2
  85.              Program options  . . . . . . . . . . . . . . . . . . . . .   2
  86.                Notes  . . . . . . . . . . . . . . . . . . . . . . . . .   2
  87.                Printer  . . . . . . . . . . . . . . . . . . . . . . . .   2
  88.                Single line vs. cascading chart  . . . . . . . . . . . .   3
  89.                Paging . . . . . . . . . . . . . . . . . . . . . . . . .   4
  90.                Reset the printer  . . . . . . . . . . . . . . . . . . .   4
  91.  
  92.           What's it doing?  . . . . . . . . . . . . . . . . . . . . . .   4
  93.  
  94.           Random thoughts on data entry . . . . . . . . . . . . . . . .   5
  95.              FIELD USE  . . . . . . . . . . . . . . . . . . . . . . . .   5
  96.              NAMES  . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  97.              MARRIAGES  . . . . . . . . . . . . . . . . . . . . . . . .   6
  98.              NOTES  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  99.  
  100.           HOW2READ.TXT file . . . . . . . . . . . . . . . . . . . . . .   7
  101.  
  102.           Problem resolution  . . . . . . . . . . . . . . . . . . . . .   7
  103.  
  104.           PRINTALT program  . . . . . . . . . . . . . . . . . . . . . .   8
  105.  
  106.           Printing the report with a word processor . . . . . . . . . .   9
  107.  
  108.           Printing the report on an unsupported printer . . . . . . . .   9
  109.  
  110.           Liability Statement and Disclaimer  . . . . . . . . . . . . .  10
  111.  
  112.           The Shareware Concept . . . . . . . . . . . . . . . . . . . .  10
  113.  
  114.           Registration  . . . . . . . . . . . . . . . . . . . . . . . .  11
  115.  
  116.  
  117.  
  118.  
  119.           ---------------------------------------------------------------
  120.                                         Page i
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                    PAFAbility v1.2
  134.           ----------------------------------------------------------------
  135.  
  136.           Introduction
  137.           ------------
  138.  
  139.           PAFAbility is an accessory program for users of Personal
  140.           Ancestral File.  PAFAbility reads the Family Record (FR) data
  141.           files to produce a Record (also known as Modified Register)
  142.           System format descendants report.  The user has the option of
  143.           creating a single line report (listing the descendants of one
  144.           individual) or a multiple line report (listing the descendants of
  145.           each ancestor of a specified individual).
  146.  
  147.           Personal Ancestral File is a registered trademark of the
  148.           Corporation of the President of The Church of Jesus Christ of
  149.           Latter-Day Saints.
  150.  
  151.           Hardware Requirements
  152.           ---------------------
  153.  
  154.           PAFAbility runs on all classes of MS-DOS compatible computers.
  155.  
  156.           If memory above 640K is available, it will be used to hold the
  157.           NAME2.DAT file so that the maximum amount of conventional memory
  158.           is available for the program's use.
  159.  
  160.           The program supports Epson compatible dot matrix printers,
  161.           Hewlett Packard LaserJet compatible printers and provides an
  162.           option for no printer codes to be used.
  163.  
  164.  
  165.           Using PAFAbility
  166.           ----------------
  167.  
  168.           No installation or configuration is required to run this version
  169.           of PAFAbility.  This version of the program assumes that the FR
  170.           data files are in the current DOS directory.  For example,
  171.           suppose the data files you wish to use are in the C:\PAF\BENNETT
  172.           directory and the PAFAbility program is in the C:\PAF\OTHPGMS
  173.           directory.  To execute PAFAbility, you must do the following:
  174.  
  175.           cd\paf\bennett
  176.           \paf\othpgms\pafablty
  177.  
  178.  
  179.           ---------------------------------------------------------------
  180.                                         Page 1
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                    PAFAbility v1.2
  194.           ----------------------------------------------------------------
  195.  
  196.           WARNING:  This program has the potential to print hundreds of
  197.           pages.  You may wish to capture the report to disk and look at
  198.           the output before sending it to the printer.  PRN2FILE.COM, a
  199.           free utility from PC-Magazine which intercepts printer output, is
  200.           included in the distribution packet.
  201.  
  202.  
  203.           Program options
  204.           ---------------
  205.  
  206.           There are no command line options in this version of the program. 
  207.           After the program loads, it will ask a few questions to gather
  208.           the information needed for the current run.  The answers may be
  209.           entered in upper or lower case.
  210.  
  211.           Notes
  212.           -----
  213.  
  214.           All notes, Fgs notes, No notes?
  215.  
  216.           This question refers to how much text from the NOTES2.DAT file
  217.           should be included in the report. Enter "A" to include all notes
  218.           in the report.  Enter "F" to include only Family Group Sheet
  219.           notes, i.e., those notes which are flagged with "!".  Enter "N"
  220.           to ignore the notes file.
  221.  
  222.           Note: This version of PAFAbility does not print notes that are
  223.           stored in text files. It assumes the notes are in the NOTES2.DAT
  224.           file.
  225.  
  226.           Printer
  227.           -------
  228.  
  229.           Do you want Dot matrix, HP Laser printer, or None?
  230.  
  231.           The answer to this question determines which, if any, printer
  232.           codes are included in the report.  Enter "D" if you have an Epson
  233.           compatible dot matrix computer.  Enter "L" if you are using a
  234.           Hewlett Packard compatible laser printer.  Enter "N" if you have
  235.           an incompatible printer or don't want to include printer codes in
  236.           the report.
  237.  
  238.  
  239.           ---------------------------------------------------------------
  240.                                         Page 2
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.                                    PAFAbility v1.2
  254.           ----------------------------------------------------------------
  255.  
  256.           The report is designed for compressed print (17 characters per
  257.           line) with eight lines per inch.
  258.  
  259.           The codes used for the dot matrix printer are:
  260.                ESC SI - to turn on compressed print
  261.                ESC 0  - to turn on 1/8-inch line spacing
  262.                ESC @  - to reset the printer to its normal settings
  263.  
  264.           The codes used for the laser printer are:
  265.                ESC (8U ESC (s0p16.66h8.5v0s0b0T - to select the line
  266.                                                   printer font
  267.                ESC &l8D - to select 1/8-inch line spacing
  268.                ESC E    - to reset the printer to its normal settings
  269.  
  270.  
  271.           If your printer is not compatible with these codes, choose "N"
  272.           for no printer and use PRN2FILE to capture the output to disk.
  273.           Then, set up your word processor program with the correct
  274.           settings, import the report file and print it.
  275.  
  276.  
  277.           Single line vs. cascading chart
  278.           -------------------------------
  279.  
  280.           Do you want a Single line or a Cascading Chart? Enter S or C:
  281.  
  282.           Enter "S" if you want to create a single line report that shows
  283.           the descendants of a specified individual.  Enter "C" if you want
  284.           to create a chart for each end-of-line ancestor for a specified
  285.           individual.
  286.  
  287.           If you enter "S", you will be asked for the RIN of the individual
  288.           whose descendants you want to list.  For example, if I wanted to
  289.           create a report of all descendants of John Bennett, I would enter
  290.           "270" which is his RIN.
  291.  
  292.           If you enter "C", you will be asked for the RIN of the base
  293.           individual to use for the cascading chart. For example, my RIN is
  294.           3. To create a report that contains a descendants chart for each
  295.           of my end-of-line ancestors, I would enter "3" in response to
  296.           this question. If I wanted to create a report of just my father's
  297.           side of the family, I would enter "1" which is his RIN.
  298.  
  299.           ---------------------------------------------------------------
  300.                                         Page 3
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.                                    PAFAbility v1.2
  314.           ----------------------------------------------------------------
  315.  
  316.           Paging
  317.           ------
  318.  
  319.           Start each generation on a new page? Enter Y or N:
  320.  
  321.           Enter "Y" if you wish to have a page break between generations.
  322.           This would have the effect of creating a chapter for each
  323.           generation. However, be aware that this can cause a significant
  324.           increase in the number of total pages printed.
  325.  
  326.           Enter "N" if you wish to save paper.
  327.  
  328.           Reset the printer
  329.           -----------------
  330.  
  331.           Reset printer when report is finished? Enter Y or N:
  332.  
  333.           If you are printing directly to the printer and you want the
  334.           normal printer settings restored when the program ends, enter
  335.           "Y".
  336.  
  337.           If you are capturing the report to disk with PRN2FILE or a
  338.           similar program with the intention of printing your report on
  339.           both sides of the paper, enter "N".  If the printer reset code is
  340.           included in the disk report, it will probably cause undesirable
  341.           results when you try to print alternate pages.
  342.  
  343.           What's it doing?
  344.           ----------------
  345.  
  346.           After you've selected the options to be used for the report, the
  347.           program reads the data and writes the report. A page counter
  348.           reporting the progress is displayed on the screen. An index entry
  349.           for each individual named in the report is built and held in
  350.           memory.
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.           ---------------------------------------------------------------
  360.                                         Page 4
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.                                    PAFAbility v1.2
  374.           ----------------------------------------------------------------
  375.  
  376.           After all the descendants' information is printed, the index
  377.           entries that were held in memory are reformatted and sorted. The
  378.           message "Sorting index" appears on the screen. If there is not
  379.           enough memory to sort all the names at the same time, temporary
  380.           disk files will be used. If there is not enough free disk space
  381.           for the sort work files, the program will fail. Unfortunately,
  382.           there is no way to calculate how much disk space will be needed.
  383.  
  384.           After the index entries are sorted, the index is printed. A page
  385.           counter reporting the progress is displayed on the screen. If
  386.           nothing went wrong during the sort phase, the program terminates
  387.           with the message "Program successfully completed."
  388.  
  389.  
  390.           Random thoughts on data entry
  391.           -----------------------------
  392.  
  393.           FIELD USE
  394.                The program assumes, as does PAF, that each field contains
  395.                what it was intended to contain. That is, the surname field
  396.                contains a surname; the title field contains a title; etc.
  397.                If you've done as I have and used fields in ways they
  398.                weren't intended - I enter (twin) in the title field to
  399.                indicate multiple births - then the report output may not
  400.                make sense.
  401.  
  402.           NAMES
  403.                This version of the program considers the title to be part
  404.                of the surname when the index entries are sorted. Therefore,
  405.                some names in the index will not appear in the order you
  406.                expect.
  407.  
  408.                Names that don't follow the expected pattern, such as
  409.                "William the Conqueror", will probably not appear in the
  410.                index as one would like. How it will be sorted depends upon
  411.                what was entered in the surname and title fields. I don't
  412.                know of a solution for this problem, since existing versions
  413.                of PAF don't provide well for this type of name.
  414.  
  415.  
  416.  
  417.  
  418.  
  419.           ---------------------------------------------------------------
  420.                                         Page 5
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                                    PAFAbility v1.2
  434.           ----------------------------------------------------------------
  435.  
  436.           MARRIAGES
  437.                PAF assumes that a liason that produces children is a
  438.                marriage. Since PAF provides no way to indicate otherwise,
  439.                that assumption is also used in this program.
  440.  
  441.           NOTES
  442.                I have not always been consistent in the way I entered data
  443.                in the notes file. I quit using the FGS Note indicator back
  444.                when version 2 of PAF was released because I figured I
  445.                always wanted all my notes printed. However, that's not
  446.                appropriate for my purposes with this report. I've decided
  447.                to enter any biographical narrative text as the first FGS
  448.                note(s) for an individual. The next FGS note is: "Sources
  449.                for <individual's name>:". This note is followed by the FGS
  450.                notes containing the source citations for the data. Each
  451.                source citation is followed by the data extracted from that
  452.                source. This data is NOT marked as an FGS note. Here's an
  453.                example:
  454.  
  455.                !John J Arbaugh says: Adam was born on the farm one mile
  456.                north of Jewett, Ohio, owned in 1946 by Ira Arbaugh (gson of
  457.                Adam's brother, John). Adam received a meager education in
  458.                the Orr School. Rev. Benjamin Pope, Lutheran minister
  459.                officiated at his wedding.
  460.  
  461.                !Sources for Adam Arbaugh:
  462.  
  463.                !RESIDENCE-PARENTS:
  464.                   Commemorative Biographical Record, Harrison, Ohio,
  465.                   containing Biographical Sketches of Prominent and
  466.                   Representative Citizens, and of many of the early
  467.                   Settled Families; Chicago: J.H. Beers & Co., 1891;
  468.                   Arbaugh/OH/0001; p. 163, 513.
  469.  
  470.                   "Of the children of John Arbaugh two are living - ... and
  471.                    Adam, in Van Buren County, Iowa."
  472.  
  473.                   "... Adam ..."
  474.  
  475.  
  476.  
  477.  
  478.  
  479.           ---------------------------------------------------------------
  480.                                         Page 6
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.                                    PAFAbility v1.2
  494.           ----------------------------------------------------------------
  495.  
  496.                !BIRTH-MARRIAGE-OCCUPATION-RESIDENCE:
  497.                   1885 Iowa State Census; Van Buren County, Iowa; p. 357-8,
  498.                   Family 175, Dwelling 166; Lick Creek Twp, Township 70,
  499.                   Range 10, Section 19; Church of Jesus Christ of Latter
  500.                   Day Saints Family History Library, microfilm #1020187
  501.  
  502.                   Age 62, married, farmer, entitled to vote. Living E side
  503.                   NE 1/4 ??
  504.  
  505.  
  506.           HOW2READ.TXT file
  507.           -----------------
  508.  
  509.           A file named HOW2READ.TXT is included in the PAFAbility
  510.           distribution package. This file is a one-page explanation of how
  511.           to read the report. You may wish to print this file and include
  512.           it with reports that you send to others.
  513.  
  514.  
  515.           Problem resolution
  516.           ------------------
  517.  
  518.           If you have any problems running the program, the most likely
  519.           reason is that there isn't enough memory available for the size
  520.           report you requested. An error message that says "Failed to init
  521.           <something or other>, Status = 8" means that there wasn't enough
  522.           memory. Try making more memory available by removing any TSR
  523.           programs that you have loaded into memory.
  524.  
  525.           I was able to create a report with 3393 subjects and spouses on a
  526.           640K 8088 class machine with 511K available before the program
  527.           was invoked.  The resulting report, which included all notes, was
  528.           1124 pages long; captured to disk, the file was over 4 megabytes.
  529.  
  530.           If you need help, please contact me. The following items will
  531.           help in resolving any problems:
  532.                description of your hardware: class of machine (8088, 80286,
  533.                   etc), amount of memory, printer model, etc
  534.                a screen print showing any error messages
  535.                the options you selected and a copy of your PAF data files
  536.  
  537.  
  538.  
  539.           ---------------------------------------------------------------
  540.                                         Page 7
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.                                    PAFAbility v1.2
  554.           ----------------------------------------------------------------
  555.  
  556.           If you find something wrong with the report, please send me the
  557.           following information:
  558.  
  559.                a description of the problem
  560.                a copy of the report page showing the problem
  561.                the option you selected and a copy of your PAF data files
  562.  
  563.           Send the information to:
  564.                Barbara A. Bennett
  565.                6426 Pound Apple Court
  566.                Columbia, MD 21045
  567.  
  568.  
  569.           PRINTALT program
  570.           ----------------
  571.  
  572.           My PAF database currently contains over 6000 individuals. A
  573.           report for my mother's side of the family is about 800 pages. In
  574.           order to save paper, I wanted to print on both sides of the
  575.           paper. None of the public domain or shareware programs I have
  576.           tried have worked successfully for me. So, I wrote a program
  577.           called PRINTALT which is included in the distribution packet.
  578.  
  579.           PRINTALT reads the report file captured by PRN2FILE and prints
  580.           the odd pages. It then prompts the user to turn the paper over
  581.           and prints the even pages.  PRINTALT is what one of my coworkers
  582.           calls a "hurry up quick" or others call "quick & dirty".  It is a
  583.           no frills program and does very little, if any, error trapping. 
  584.           It works for me but I don't guarantee that it will work for you. 
  585.           I would not expect it to work on any file other than the report
  586.           created by PAFAbility.  If you have a printer jam or run out of
  587.           paper on page 500 of a 600 page report, there's no way to
  588.           recover.
  589.  
  590.           If your word processor is capable of printing alternate pages, I
  591.           recommend you use it for this purpose.
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.           ---------------------------------------------------------------
  600.                                         Page 8
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.                                    PAFAbility v1.2
  614.           ----------------------------------------------------------------
  615.  
  616.           Printing the report with a word processor
  617.           -----------------------------------------
  618.  
  619.           The report may be captured to disk using PRN2FILE or a similar
  620.           utility.  If you wish to print the report using a word processor,
  621.           you must set the word processor as follows in order to properly
  622.           print the report as formatted:
  623.                17 characters per inch
  624.                8 lines per inch
  625.                0" left and right margins
  626.                0" top and bottom margins
  627.  
  628.           The report is designed for a monospaced font such as Courier. 
  629.           Use of a proportional spaced font will produce unexpected
  630.           results.
  631.  
  632.  
  633.           Printing the report on an unsupported printer
  634.           ---------------------------------------------
  635.  
  636.           If you captured the report to disk and chose "no printer" because
  637.           your printer is not supported by the program, then you must send
  638.           the proper control codes to your printer before attempting to
  639.           print the report.  You must set the printer for 17 characters per
  640.           inch and 8 lines per inch.
  641.  
  642.  
  643.           Using PRN2FILE
  644.           --------------
  645.  
  646.           PRN2FILE intercepts data sent to the printer and writes it to the
  647.           designated disk file.  To send the report to a file named BOOK,
  648.           enter the following command at the DOS prompt before invoking
  649.           PAFAbility:
  650.  
  651.           prn2file book
  652.  
  653.           After PAFAbility has ended, enter the following command to flush
  654.           the last bit of the report to the file and terminate printer
  655.           interception:
  656.  
  657.           prn2file
  658.  
  659.           ---------------------------------------------------------------
  660.                                         Page 9
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.                                    PAFAbility v1.2
  674.           ----------------------------------------------------------------
  675.  
  676.           Liability Statement and Disclaimer
  677.           ----------------------------------
  678.  
  679.           The author of this program hereby disclaims all warranties
  680.           relating to this software, whether express or implied, including
  681.           without limitation any implied warranties of merchantability or
  682.           fitness for a particular purpose. The author will not be liable
  683.           for any special, incidental, consequential, indirect or similar
  684.           damages due to loss of data or any other reason, even if the
  685.           authro or an agent of the author has been advised of the
  686.           possibility of such damages. In no event shall the author's
  687.           liability for any damages ever exceed the price paid for the
  688.           license to use software, regardless of the form of the claim. 
  689.           The person using the software bears all risk as to the quality
  690.           and performance of the software.
  691.  
  692.  
  693.           The Shareware Concept
  694.           ---------------------
  695.  
  696.           PAFAbility is distributed as shareware. Shareware is commercial
  697.           software distributed in an unconventional manner.  Microcomputers
  698.           copy information very easily.  Instead of trying to frustrate
  699.           this through copy protection, shareware takes advantage of it to
  700.           reach as many users as possible at the lowest cost. Anyone may
  701.           copy a shareware program and distribute it to whomever they
  702.           desire, provided they do not charge a fee or alter it.
  703.  
  704.           Shareware isn't free.  Serious shareware is as polished as any
  705.           conventional commercial product, and represents just as much
  706.           programming effort.  If you use it regularly, the authors expect
  707.           compensation.
  708.  
  709.           However, unlike conventional distribution, shareware allows you
  710.           to evaluate the product before you decide to purchase it.  The
  711.           price is often lower, as well, because there are no advertising,
  712.           packaging, or distribution costs.
  713.  
  714.           But it can only work with your support.  If you are still using a
  715.           shareware product after a couple of weeks, then it is obviously
  716.           worth something to you, and you should register it.
  717.  
  718.  
  719.           ---------------------------------------------------------------
  720.                                        Page 10
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                                    PAFAbility v1.2
  734.           ----------------------------------------------------------------
  735.  
  736.           Registration
  737.           ------------
  738.  
  739.           To register your copy of PAFAbility, send in a completed copy of
  740.           the enclosed order form (ORDER.FRM) with a check or money order
  741.           for $10.
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.           ---------------------------------------------------------------
  780.                                        Page 11
  781.